home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 301_400 / DISK0378 / DISK0378.ZIP / FOGFIN.DOC < prev    next >
Text File  |  1984-06-11  |  8KB  |  189 lines
  1. r
  2.  
  3.  
  4.  
  5.                             FOG FINDER Version 1.0 
  6.   
  7.   
  8.               
  9.  
  10.  
  11.          INTRODUCTION
  12.  
  13.               Most people have taken creative writing or grammar 
  14.          classes.  These classes are designed to improve a 
  15.          person's writing.  Creative writing classes will spur a 
  16.          person's imagination; grammar classes stress the 
  17.          building-block approach to writing.                                   
  18.  
  19.               There is a third technique geared to improve your 
  20.          writing.  This approach judges the "readability" of 
  21.          writing.  It grades writing from the reader's side; i.e. 
  22.          do people find it easy to read.
  23.  
  24.               If you've ever struggled through the 1040 Federal 
  25.          Tax instruction booklet, you can appreciate that some 
  26.          writing is very difficult to read.  The 1040 
  27.          instructions might satisfy the grammarians, and it might 
  28.          treat the subject in as creative a way as possible, but 
  29.          it fails the third test.  It is very complex, confusing, 
  30.          and "unreadable" writing.  It is far past the tolerance 
  31.          level of most readers.
  32.  
  33.               Complex subject matter does not necessarily mean 
  34.          complex writing.  In fact, a good writer should strive 
  35.          for the opposite.  If the subject is complex, then keep 
  36.          the writing as simple as possible.  Otherwise, you might 
  37.          end out swamping the poor reader.
  38.  
  39.               Researchers have been studying the characteristics 
  40.          of readable writing for about 50 years.  They have 
  41.          devised several formulas to evaluate writing; most of 
  42.          these formulas deal with sentence length and word 
  43.          complexity.  One such formula is the Gunning Fog Index.
  44.  
  45.               
  46.          FOG INDEX
  47.  
  48.               The Gunning Fog Index measures the complexity in 
  49.          writing.  It represents the complexity as an average 
  50.          grade level (elementary, high school, college) at which 
  51.          the text could be easily read.  For instance, a Fog 
  52.          Index of 9 means 9th grade reading level.
  53.  
  54.               Most successful popular writing grades below a 13 
  55.          on a Fog Index scale.  As the Fog Index rises, people 
  56.          will find the text more and more difficult to read.  
  57.          Government and business writing often has a very high 
  58.   
  59.                                                                          Page 1
  60.  
  61.  
  62.  
  63.                             FOG FINDER Version 1.0 
  64.   
  65.   
  66.          Fog Index.  This high Fog Index means that people will 
  67.          have trouble reading and understanding the writing.
  68.  
  69.               Complex subjects need not have a high Fog Index.  
  70.          The Wall Street Journal, a prime example of clear and 
  71.          concise coverage of complex subjects, averages around an 
  72.          11 on the Fog Index scale.
  73.  
  74.               Note that a low Fog Index does not mean a piece of 
  75.          text is a sample of "good" writing, only that it is 
  76.          probably a piece of writing that is easy to read.  
  77.          However, most of what you consider "good" writing will 
  78.          probably score low on the Fog Index.
  79.               
  80.                             
  81.          USING FOG FINDER
  82.  
  83.               FOGFIND.COM is a compiled Pascal program that 
  84.          accepts a text file and grades it on a slightly modified 
  85.          Gunning Fog Index.  The text file should be an ASCII 
  86.          file; it shouldn't have any special control codes 
  87.          imbedded in the text (printer controls are okay).  Fog 
  88.          Finder will process a file with special codes (for 
  89.          example, a WordStar file), but the resulting Fog Index 
  90.          may not be accurate.
  91.  
  92.               From DOS, enter FOGFIND to begin the program.  You 
  93.          will receive a title screen introducing Fog Finder.  
  94.          Press any key to continue.  (Note:  I don't know why, 
  95.          but sometimes you have to press a key a couple of 
  96.          times.) 
  97.  
  98.               Fog Finder will prompt you for the name of your 
  99.          text file.  It will then try to open and read the file.  
  100.          If Fog Finder cannot do so, it will prompt you to 
  101.          re-enter the file name.  (example: file does not exist)
  102.  
  103.               If the open is successful, Fog Finder will begin 
  104.          processing.  You'll see a running tally of words and 
  105.          sentences.  Fog Finder will continue processing until 
  106.          either:  A) It reaches the end of the file, or  B) It
  107.          has processed 50 sentences.
  108.  
  109.               The 50 sentence limit allows you to process a 
  110.          sample from a long text file.  The 50 sentence sample is 
  111.          more than enough to generate a representative Fog Index.
  112.  
  113.               After processing your text, Fog Finder displays a 
  114.          Fog Index table, a graphic showing your sample's Fog 
  115.          Index range, and your actual Fog Index.  You will have 
  116.   
  117.                                                                          Page 2
  118.  
  119.  
  120.  
  121.                             FOG FINDER Version 1.0 
  122.   
  123.   
  124.          the option to process another file or to terminate the 
  125.          program.
  126.  
  127.           
  128.          REMEMBER
  129.               
  130.               A Fog Index is only a measure of what people 
  131.          consider easy reading.  It doesn't measure whether the 
  132.          writing is good, bad, dull, interesting, clear, or 
  133.          muddy.  However, it will measure whether the writing 
  134.          will tire the reader beacuse of the way the words and 
  135.          sentences are assembled.
  136.  
  137.               
  138.          ENHANCEMENTS
  139.  
  140.               Future versions of Fog Finder will accept special 
  141.          text files (WordStar, MultiMate, etc.).  Registered 
  142.          users will automatically receive a copy of the next 
  143.          version.  All written suggestions for enhancements are 
  144.          encouraged.
  145.  
  146.  
  147.          PERMISSION TO COPY
  148.               
  149.               Users are encouraged to copy and share this program 
  150.          and documentation, as long as no price is charged for 
  151.          the software or documentation.  A small distribution 
  152.          charge may be made for the cost of the diskette.
  153.  
  154.               If you use this program and find it of value, you 
  155.          may register your copy by sending a contribution ($15 
  156.          suggested) to:
  157.                        
  158.  
  159.                              Joey Robichaux
  160.                          1036 Brookhollow Drive
  161.                          Baton Rouge, La.  70810
  162.  
  163.                             
  164.                 Registered users will automatically receive a 
  165.          copy of the next version of Fog Finder.  Regardless of 
  166.          whether or not you register you copy, you are encouraged 
  167.          to share it with your friends.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.                                                                   Page 3
  174.  
  175.  
  176. Press ENTER to continue: 
  177.  
  178.  
  179.         This disk copy was originally provided by "The Public Library",
  180.         the software library of the Houston Area League of PC Users.
  181.         Disks in the Public Libray are updated monthly.  Check with us
  182.         for the latest versions of all programs.
  183.  
  184.         Programs are available from the Public Library at $2 per disk
  185.         on user-provided disks.  To get a listing of the disks in the
  186.         Public Library, send a self-addressed, stamped envelope to
  187.  
  188.              Nelson Ford,  P.O.Box 61565,  Houston, TX 77208.
  189.